home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / v.z / v
Encoding:
Text File  |  1998-10-20  |  8.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. vvvv((((3333GGGG))))                                                                    vvvv((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      vvvv2222dddd,,,, vvvv2222ffff,,,, vvvv2222iiii,,,, vvvv2222ssss,,,, vvvv3333dddd,,,, vvvv3333ffff,,,, vvvv3333iiii,,,, vvvv3333ssss,,,, vvvv4444dddd,,,, vvvv4444ffff,,,, vvvv4444iiii,,,, vvvv4444ssss - transfers a
  10.      2-D, 3-D, or 4-D  vertex to the graphics pipe
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv2222ssss((((vvvveeeeccccttttoooorrrr))))              ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv2222ffff((((vvvveeeeccccttttoooorrrr))))
  14.      iiiinnnntttteeeeggggeeeerrrr****2222 vvvveeeeccccttttoooorrrr((((2222))))                 rrrreeeeaaaallll vvvveeeeccccttttoooorrrr((((2222))))
  15.  
  16.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv2222iiii((((vvvveeeeccccttttoooorrrr))))              ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv2222dddd((((vvvveeeeccccttttoooorrrr))))
  17.      iiiinnnntttteeeeggggeeeerrrr****4444 vvvveeeeccccttttoooorrrr((((2222))))                 ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn vvvveeeeccccttttoooorrrr((((2222))))
  18.  
  19.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv3333ssss((((vvvveeeeccccttttoooorrrr))))              ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv3333ffff((((vvvveeeeccccttttoooorrrr))))
  20.      iiiinnnntttteeeeggggeeeerrrr****2222 vvvveeeeccccttttoooorrrr((((3333))))                 rrrreeeeaaaallll vvvveeeeccccttttoooorrrr((((3333))))
  21.  
  22.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv3333iiii((((vvvveeeeccccttttoooorrrr))))              ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv3333dddd((((vvvveeeeccccttttoooorrrr))))
  23.      iiiinnnntttteeeeggggeeeerrrr****4444 vvvveeeeccccttttoooorrrr((((3333))))                 ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn vvvveeeeccccttttoooorrrr((((3333))))
  24.  
  25.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv4444ssss((((vvvveeeeccccttttoooorrrr))))              ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv4444ffff((((vvvveeeeccccttttoooorrrr))))
  26.      iiiinnnntttteeeeggggeeeerrrr****2222 vvvveeeeccccttttoooorrrr((((4444))))                 rrrreeeeaaaallll vvvveeeeccccttttoooorrrr((((4444))))
  27.  
  28.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv4444iiii((((vvvveeeeccccttttoooorrrr))))              ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee vvvv4444dddd((((vvvveeeeccccttttoooorrrr))))
  29.      iiiinnnntttteeeeggggeeeerrrr****4444 vvvveeeeccccttttoooorrrr((((4444))))                 ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn vvvveeeeccccttttoooorrrr((((4444))))
  30.  
  31. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  32.      _v_e_c_t_o_r   expects a 2, 3, or 4 element array, depending on whether you
  33.               call the vvvv2222, vvvv3333, or vvvv4444 version of the routine.  The elements of
  34.               the array are the coordinates of the vertex (point) that you
  35.               want to transfer to the graphics pipe. Put the _x coordinate in
  36.               element 1, the _y coordinate in element 2, the _z coordinate in
  37.               element 3 (for vvvv3333 and vvvv4444), and the _w coordinate in element 4
  38.               (for vvvv4444).
  39.  
  40. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  41.      vvvv transfers a single 2-D (vvvv2222), 3-D (vvvv3333), or 4-D (vvvv4444) vertex to the
  42.      graphics pipe.  The coordinates are passed to vvvv as an array. Separate
  43.      subroutines are provided for 16-bit integers (ssss), 32-bit integers limited
  44.      to a signed 24-bit range (iiii), 32-bit IEEE single precision floats (ffff),
  45.      and 64-bit IEEE double precision floats (dddd).  The _z coordinate defaults
  46.      to 0.0 if not specified.  _w defaults to 1.0.
  47.  
  48.      The Graphics Library subroutines bbbbggggnnnnppppooooiiii, eeeennnnddddppppooooiiii, bbbbggggnnnnlllliiiinnnn, eeeennnnddddlllliiiinnnn, bbbbggggnnnncccclllloooo,
  49.      eeeennnnddddcccclllloooo, bbbbggggnnnnppppoooollll, eeeennnnddddppppoooollll, bbbbggggnnnnttttmmmmeeee, eeeennnnddddttttmmmmeeee, bbbbggggnnnnqqqqsssstttt, and eeeennnnddddqqqqsssstttt determine how
  50.      the vertex is interpreted.  For example, vertices specified between
  51.      bbbbggggnnnnppppooooiiii and eeeennnnddddppppooooiiii draw single pixels (points) on the screen.  Likewise,
  52.      those specified between bbbbggggnnnnlllliiiinnnn and eeeennnnddddlllliiiinnnn draw a sequence of lines (with
  53.      the line stipple continued through internal vertices).  Closed lines
  54.      return to the first vertex specified, producing the equivalent of an
  55.      outlined polygon.
  56.  
  57.      Vertices specified when none of bbbbggggnnnnppppooooiiii, bbbbggggnnnnlllliiiinnnn, bbbbggggnnnncccclllloooo, bbbbggggnnnnppppoooollll, bbbbggggnnnnttttmmmmeeee,
  58.      and bbbbggggnnnnqqqqsssstttt are active simply set the current graphics position.  They do
  59.      not have any effect on the frame buffer contents.  (Refer to the pages
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. vvvv((((3333GGGG))))                                                                    vvvv((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      for bbbbggggnnnnppppooooiiii, bbbbggggnnnnlllliiiinnnn, bbbbggggnnnncccclllloooo, bbbbggggnnnnppppoooollll, bbbbggggnnnnttttmmmmeeee, and bbbbggggnnnnqqqqsssstttt for their effect
  75.      on the current graphics position.)
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      bgnclo, bgnlin, bgnpoi, bgnpol, bgntme, bgnqst
  79.  
  80. BBBBUUUUGGGGSSSS
  81.      On the IRIS-4D/120GTX and IRIS-4D/140GTX, there is problem with the
  82.      graphics DMA hardware that can cause data to be sent to the hardware
  83.      after the subroutine call has returned.  If the data is modified immedi-
  84.      ately after the subroutine call, the modified data may get sent down.  To
  85.      avoid this, don't modify the data until after another nnnn, vvvv, or cccc call has
  86.      been made.
  87.  
  88.      This is an example of the bug:
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.